home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / music / 55 / applic / dbtut1.txt < prev    next >
Text File  |  1986-09-18  |  11KB  |  267 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                 dBMAN Tutorials
  9.                                  #1 in a Series
  10.                                General/Bug Report
  11.                                 by John C. Leon
  12.                                 August 20, 1986
  13.  
  14.  
  15.                      distributed through the H.A.S.T.E. BBS
  16.                   Houston Atari ST Enthusiasts   713-955-9532
  17.             permission granted to distribute unaltered original text
  18.  
  19.  
  20.           There are precious few serious  databases  on  the  market  at
  21.         present for the Atari ST. The majors are dBMAN, the Manager, and
  22.         Zoomracks.  H&D Base is a dead horse, as  Mirage has appparently
  23.         gone out  of  business.   Others  will  come.   This  series  of
  24.         articles concentrates on what appears  to  this writer to be the
  25.         single most versatile  and  powerful program, dBMAN by Versasoft
  26.         (versions 2.00L and 2.02L are  included  in  all  remarks,  with
  27.         known differences pointed out).  We assume you  have  a  working
  28.         knowledge of relational databases, and have made some effort  to
  29.         use the product.  For those who have never used a dBMAN or dBASE
  30.         type of command-driven relational database, I urge you  to buy a
  31.         book or two on dBASE programming before tackling any  heavy-duty
  32.         work  with  dBMAN.  The two products are very similar,  but  far
  33.         from directly compatible, despite consistent claims by reviewers
  34.         and any ads you may see.  Compatibility between  dBMAN and dBASE
  35.         extends only to the ability to use  the CONVERT command in dBMAN
  36.         to convert a dBASE data file to dBMAN format.
  37.  
  38.           Command files (programs) written in  dBASE  will  not  run  in
  39.         dBMAN without modification.  The syntax of the two languages  is
  40.         different, and there exist commands in each language that do not
  41.         exist in the  other.   Suffice  it  to say that the commands are
  42.         similar enough to make the porting of programs relatively easy.
  43.  
  44.           The dBMAN documentation is pretty stiff.  It is packaged in an
  45.         attractive slipcase and three-ring  binder,  containing  logical
  46.         sections:   basic,  advance,  reference,  commands,   functions,
  47.         appendices and index.  However, the level of detail leaves a lot
  48.         to  be  desired.   You  are  often  merely  presented  a   brief
  49.         description of a command or function with no  explanation of its
  50.         power or usefulness.  The SET RELATION TO command is  incredibly
  51.         powerful, but it receives the briefest of treatment (two pages -
  52.         long by Versasoft's standards!)  and no hint is given on when it
  53.         would be  useful.   Versasoft  seems to assume that users of the
  54.         product already have a great deal of savvy  on power programming
  55.         of relational databases.  I would define their entire manual  as
  56.         a technical reference piece.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.         dBMAN Tutorials              - 1 -            General/Bug Report
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                                   BUG REPORTS
  75.  
  76.         1.  The main dBMAN screen display is unstable, but this does not
  77.         appear to affect its performance.  The status line (the one that
  78.         appears   in   inverse  video),  is  prone   to   self-destruct,
  79.         disappearing in whole or in part without  any reason I can find.
  80.         Printing a report causes the  same  few  garbage  characters  to
  81.         appear in the left section of the status line every time without
  82.         exception.   If   these  kinds  of  obvious  problems  exist  in
  83.         something as basic as displaying a screen, what other bugs might
  84.         there be?
  85.  
  86.         2.  The Report Generator
  87.  
  88.              2.1.  The first screen  of  the  report generator indicates
  89.              that  you  can use the PgDn keys (CTRL-D) to  move  between
  90.              screens.  You are also told that CTRL-D is used to delete a
  91.              field you no longer  want  in  the  report.   Wrong.   It's
  92.              CTRL-E  that  erases  a   field.   Version  2.02L's  report
  93.              generator does specify use of CTRL-E.
  94.  
  95.              2.2.  I  discovered  a problem in changing  report  formats
  96.              with the MODIFY REPORT command.  As you modify the  format,
  97.              you  naturally  see  your  keystrokes  reflected  onscreen.
  98.              However, if you then save  your  changes  with  CTRL-S  and
  99.              immediately try to print your modified report, you may find
  100.              that  you  get the OLD report format!!  I have  found  that
  101.              after modifying a  report,  you  must  exit  dBMAN  to  the
  102.              desktop and reboot the  program before report modifications
  103.              "take".
  104.  
  105.              2.3.  If you specify a footer in your report, you will find
  106.              that your footer string will always  butt  up  against  the
  107.              last line of  detail  on  each  page of a report.  In other
  108.              words, there is no blank line  between  the  body  of  your
  109.              report and a page footer.  There is a  way  to  work around
  110.              this problem (see dBMAN Tutorial #2).
  111.  
  112.              2.4.  On  the  screen  where   you  specify  any  groupings
  113.              desired, you are asked if you want  a page eject after each
  114.              group.  Regardless of what you specify, you will  NOT get a
  115.              page eject.  To get a page eject,  you must not only answer
  116.              yes, but must  have  a  group  footer!  If you don't want a
  117.              group footer, specify a group footer string of ' ' (a blank
  118.              space in single or double quotes).  This is  sufficient  to
  119.              give the program what it needs to give you a page eject - a
  120.              group footer of some kind.
  121.  
  122.         3.  Procedures
  123.  
  124.              3.1.  Version 2.00L (the original ST version) can refuse to
  125.              acknowledge your procedures if you have them in folders, or
  126.              on a drive other than the drive you  booted  from,  even if
  127.  
  128.  
  129.  
  130.         dBMAN Tutorials              - 2 -            General/Bug Report
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.              you have used the SET DEFAULT TO command to reset a default
  141.              drive  and   directory.   What  happens  is  that  the  SET
  142.              PROCEDURE TO command does not preface your procedure's file
  143.              name  with  the  default  drive  and  path.  Version  2.02L
  144.              (available for $10 plus your original disk) fixes this.
  145.  
  146.              3.2.  Be extremely careful in your choice of a text  editor
  147.              to use in writing your  command  files.  All of my programs
  148.              created with the Final Word worked perfectly, until I began
  149.              to use procedures.  Apparently the SET PROCEDURE TO command
  150.              forces a search of your  entire  procedure  file,  so  that
  151.              dBMAN can set up its internal procedure table.  If you have
  152.              any non-ASCII  characters in the procedure file, dBMAN will
  153.              promptly dump you to the desktop.  I've learned that  Final
  154.              Word puts  a  non-ASCII  character as the very last byte in
  155.              the file.  That one odd end-of-file byte is  sufficient  to
  156.              kill your program entirely.  I now use another editor.
  157.  
  158.  
  159.           As additional  bugs  become  known,  we  will  inform  you  in
  160.         separate articles.   Let  us  know  of  any  problems  you  have
  161.         experienced.  We  will investigate them and advise other members
  162.         and potential purchasers.  I wrote to Versasoft on behalf of the
  163.         club on July 22, 1986, requesting information on  our ability to
  164.         update  to  version   2.02L,   and   requesting  any  additional
  165.         information on known bugs and workarounds.  After all, their own
  166.         manual suggests that if users have problems they should  contact
  167.         their dealer or  local  user  group.   This  is  a  self-serving
  168.         statement at best, but we do not object as long as  the  company
  169.         shows us some consideration by supporting the group.  As of this
  170.         date we have not received a response.
  171.  
  172.  
  173.                                     SUPPORT
  174.  
  175.           In this writer's opinion, Versasoft's  support  is  good.   My
  176.         several calls were always returned.  I  got  help  with  several
  177.         troublesome problems I  had.   The  third  time  I  called I was
  178.         politely asked  to  send  in $25 for support (they keep track!),
  179.         but they did answer my question.  When I  first  asked  about an
  180.         update policy for holders of version 2.00L, I was told there was
  181.         none.  Version 2.02L only had internal program changes.   A  few
  182.         days later I was  told  by  the  same person that I could get an
  183.         update for $10, and that some problems with the SET PROCEDURE TO
  184.         command were cured.  Get the update.  It's well worth it, as the
  185.         SET PROCEDURE TO command is very important, and  in  Versasoft's
  186.         own words, is "all screwed up" in version 2.00L.
  187.  
  188.           Versasoft's current address and phone numbers are:
  189.  
  190.              4340 Almaden Expressway #250
  191.              San Jose, CA  95118
  192.              general phone 408-723-9044
  193.  
  194.  
  195.  
  196.         dBMAN Tutorials              - 3 -            General/Bug Report
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.              support phone 408-723-8384
  207.  
  208.           As of  July  1, 1986, Atari has the marketing rights to dBMAN.
  209.         Versasoft is still the developer and source  for  support.   The
  210.         dBMAN runtime package  remains  available  direct from Versasoft
  211.         for $149.95.
  212.  
  213.           This  series  of   articles   is   anticipated  to  constitute
  214.         H.A.S.T.E.'s primary avenue of  support  for  local dBMAN users.
  215.         Many  topics  will  be  covered.   We  will not hold your  hand,
  216.         though, so please invest some time in  learning the product - we
  217.         can't teach  you  to  read the manual (life's tough!).  What you
  218.         WILL get  is  a  high  level  of  responsiveness  to  particular
  219.         problems, comments on functions and how to  use  them,  expanded
  220.         narrative on key concepts of database design, etc.
  221.  
  222.           The next tutorial will cover the report generator.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.         dBMAN Tutorials              - 4 -            General/Bug Report
  263.  
  264.  
  265.  
  266.  
  267. ə